06. Markdown 单元格
Markdown 单元格
如前所述,单元格也可用于以 Markdown 编写的文本。Markdown 是格式化语法,可让你加入链接、将文本样式设为粗体或斜体和设置代码格式。像代码单元格一样,按 Shift + Enter 或 Ctrl + Enter 可运行 Markdown 单元格,这会将 Markdown 呈现为格式化文本。加入文本可让你直接在代码旁写出叙述性文档,以及为代码和思路编写文档。
你可以 在此处查找文档 ,但我会提供简短的入门文档。
标题
要编写标题,可在文本前放置井号,即
#
(英文读作 pound、hash 或
octothorpe
)。一个
#
呈现为
h1
标题,两个
#
是 h2 标题,依此类推。类似以下所示:
# Header 1
## Header 2
### Header 3
呈现为
Header 1
Header 2
Header 3
链接
要在 Markdown 中添加链接,请在文本两侧加上方括号,并在 URL 两侧加上圆括号,例如:
[Udacity's home page](https://www.udacity.com)
表示指向
Udacity's home page
的链接。
强调效果
可以使用星号或下划线(
*
或
_
)来表示粗体或斜体,从而添加强调效果。对于斜体,在文本两侧加上一个星号或下划线,例如
_gelato_
或
*gelato*
会呈现为
gelato
。
粗体文本使用两个符号,例如
**aardvark**
或
__aardvark__
会呈现为
aardvark
。
只要在文本两侧使用相同的符号,星号和下划线的作用都一样。
代码
可以通过两种不同的方式显示代码,一种是与文本内联,另一种是将代码块与文本分离。要将代码变为内联格式,请在文本两侧加上反撇号。例如,
`string.punctuation`
会呈现为
string.punctuation
。
要创建代码块,请另起一行并用三个反撇号(一般在键盘数字 1 左边)将文本包起来:
```
import requests
response = requests.get('https://www.udacity.com')
```
或者将代码块的每一行都缩进四个空格。
import requests
response = requests.get('https://www.udacity.com')
小结
在编写 Markdown 时,可以参考这个 速查指南 。我建议使用 Markdown 单元格,与使用一堆代码块相比,这使 notebook 变得更易于阅读。